home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / mus / edit / med_3_22.lha / docs / MED3.2.doc < prev    next >
Text File  |  1991-08-22  |  84KB  |  1,814 lines
  1. ***************************************************************************
  2. **                                                                       **
  3. **          MED - music editor, © 1989 - 1991 Teijo Kinnunen             **
  4. **                                                                       **
  5. **          Instructions for MED V3.2                                    **
  6. **                                                                       **
  7. ***************************************************************************
  8.  
  9. Welcome  to  use the MED music editor!!!  MED is an all-purpose music editor
  10. that  can  be  used  to  compose music for demos, games etc., and works as a
  11. stand-alone program as well.
  12.  
  13. First  few  words  about  editing.  If you've used any Tracker, you probably
  14. know  these  things.  MED can display "standard" notes, but often you'll use
  15. the "Tracker-style" editing, in which the music is represented by note names
  16. and numbers.  For example:
  17.         01  C-2 1000  --- 0000  E-5 K210  --- 0F20
  18.         02  D-2 1000  E#1 4000  --- 0000  --- 0000
  19.         03  --- 0000  --- 0000  --- 0000  --- 0000
  20.  
  21. In this form, the music is quite fast and handy to edit when you get used to
  22. it, but it's quite useless when printed (nobody could play it).
  23.  
  24. The  song consists of blocks, every block contains 1 - 256 lines.  There can
  25. be  up  to  100 blocks and they can be played in any order and any number of
  26. times.   In addition, there can be up to 99 songs in memory at once (sharing
  27. the set of up to 63 instruments).
  28.  
  29. The  user  interface  of MED is divided in ten "panels", each one containing
  30. different  gadgets.  Only one of these panels is visible on the screen.  You
  31. can  select  the  displayed panel with ten gadgets which are always visible.
  32. There  are  lots of keyboard shortcuts.  After you've learned the use of the
  33. program,  you  probably  want to learn these shortcuts because they make the
  34. program  much  more  powerful  to use.  There are also some things which are
  35. available  only  by  using  the  keyboard,  so  you  should read the list of
  36. keyboard shortcuts at the end of this manual.
  37.  
  38. There  are  also  four  different  big  displays.   Normally  the  notes are
  39. displayed  in  this  area.  Optionally you can choose the synthsound editor,
  40. sample editor or the sample list to be displayed on this area.
  41.  
  42.  
  43. Entering the notes
  44. ==================
  45. Notes are entered with Amiga's keyboard (entering with MIDI-keyboard is also
  46. possible).  The keys are ordered in piano style:
  47.  
  48.      2 3   5 6 7   9 0   ´ \
  49.     Q W E R T Y U I O P Å ]
  50.       S D   G H J   L Ö
  51.      Z X C V B N M , . /
  52.  
  53. This way you can enter about 2,5 octaves of the 5,2 octaves available.  Keys
  54. F1 - F4 can be used to switch the octaves.  The lower row of keys (Z - /) is
  55. the lower octave, Q - U is the higher octave and keys I - \ are part of even
  56. higher octave.
  57.  
  58. If  you have an instrument loaded, you can hear the sound when you press the
  59. keys.   If  you want to enter notes onto the block, you must turn on editing
  60. (Esc).   DEL-key  is used to enter the pause (---).  The cursor can be moved
  61. with the cursor keys.
  62.  
  63. Blocks and the playing sequence
  64. ===============================
  65. When you compose a song, you do it block-by-block.  Fill a block with notes,
  66. create new block, fill it with notes...
  67.  
  68. In order to get the blocks played in correct order, you must also create the
  69. playing  sequence  list.  It is just a list of block numbers, which are then
  70. played  in that order, from beginning to end.  This way you can use the same
  71. block  many  times in your song.  When the last block from the list has been
  72. played,  the song will start again from the beginning (it's also possible to
  73. stop  the  playing).   The  maximum  length  of  the playing sequence is 256
  74. numbers.
  75.  
  76. Status bar
  77. ==========
  78. Between  the  panel  and the block display is the status bar, which displays
  79. some "strategic" information which is always good to be visible.
  80.  
  81.                                                           Song/# of songs
  82.                                                                        |
  83.                                                 Song selection gadgets |
  84.                                                                   / \  |
  85.  +-------+-----+--+-+--+----+--------+--+------------------------+-+-+-----+
  86.  |001/003|00/02|12|E|SP|CHRD|::::::::|01|AnalogString            |<|>|01/02|
  87.  +-------+-----+--+-+--+----+--------+--+------------------------+-+-+-----+
  88.      |       |  |  |  |  |      |      |         |
  89. Playseq-ptr  |  |  |  |  |    Tracks  Instr #   Instrument name
  90.              |  |  |  |  Chord mode on/off
  91.         Block # |  |  Insert empty space between notes
  92.                 |  |
  93.  Keyboard octaves  Editing on
  94.  
  95. Playseq-ptr: The first number is the current playing sequence number
  96.              (starting from 1) and the second is the number of playing
  97.              sequence numbers in the song. The 1st number is meaningful
  98.              when you're playing the song or editing the playseq list.
  99.  
  100. Block #:     The first number is the number of the current block (starting
  101.              from 0) and the 2nd is the number of the last block. It does
  102.              not tell how many blocks there are, but if you add 1 to it,
  103.              it does. In the example there are 3 blocks, and the first
  104.              is currently displayed.
  105.  
  106. Keyboard octaves:
  107.              This number tells you which octaves are currently in use
  108.              when you play the Amiga keyboard. The first number is the
  109.              octave number of the lower row of keys and the 2nd is the
  110.              higher. It can be changed with F1 - F4.
  111.  
  112. Editing on:  This is a quite important option. When the editing is off,
  113.              you can't insert notes or numbers to the song. To turn it
  114.              on/off press Esc or click the "E" with mouse. When the "E"
  115.              is highlighted, editing is on.
  116.  
  117. SP:          This switch activates the extra space between the notes you
  118.              enter. It is useful when you're entering slow pieces of music.
  119.              You don't have to hit DEL so often.
  120.  
  121. CHRD:        This turns the chord entering mode on/off.
  122.  
  123. Tracks:      It's possible to switch tracks on/off during editing. The 16
  124.              points represent the 16 possible tracks. When the point is
  125.              red (default) the track is turned on. When it's white, then
  126.              this track is turned off.
  127.  
  128. Instr #:     The number of the current instrument. The maximum number of
  129.              instruments is 63. The instruments are numbered 01 - 1V
  130.              (01 - 09, 0A - 0V, 10 - 19, 1A - 1V).
  131.  
  132. Instrument name:
  133.              The name of the current instrument.
  134.  
  135. Song handling gadgets are discussed below.
  136.  
  137. You  can change the instrument number, current block and current playseq ptr
  138. by  clicking  on  the number you want to change with the mouse.  Left button
  139. increases,  right  button  decreases.   This  is  the fastest way to advance
  140. playseq ptr for example by 100:  click the 100's number with LMB.
  141.  
  142. Instruments
  143. ===========
  144. As  noted  above,  there can be up to 63 instruments in one song.  There are
  145. currently  four  types  of instruments:  samples, synthsounds, hybrid sounds
  146. and MIDI instruments.
  147.  
  148. Samples: These are the instruments which are played through four Amiga
  149.          audio channels. They can be played only within tracks 0 - 3.
  150.          MED can load raw samples and IFF 8SVX 1, 3 and 5-octave samples.
  151.          It means that you can load practically any sample to MED and
  152.          use it in your songs. Note that raw samples and 1-octave 8SVX
  153.          samples can use only octaves 1 - 3. Octaves 4 and 5 play from
  154.          octave 3.
  155.  
  156. Synthsounds:
  157.          These are a special instruments, that allow you to construct
  158.          a sound from simple pieces of waveforms, and controlling things
  159.          like waveform #, volume, pitch, arpeggio and vibrato using a
  160.          simple "programming language". Synthsounds sound usually quite
  161.          simple (C-64 style), but they don't take much memory, either.
  162.  
  163. Hybrid sounds:
  164.          This is a normal sample, but it can be controlled using the
  165.          same "programming language" as synthsounds.
  166.  
  167. MIDI instruments:
  168.          These are not actually instruments. They are just few settings
  169.          which cause the notes played with that instrument to be sent
  170.          through MIDI-interface. They don't take memory like the samples.
  171.          When you want some instrument to be a MIDI-instrument, you must
  172.          set the MIDI channel which is used when playing notes/effects.
  173.          You can also set the preset value for the instrument. Then
  174.          the instrument is automatically played using that preset number
  175.          of your MIDI-device (synthesizer, keyboard...). You can also
  176.          set the preset number to 0. Then the preset which is already
  177.          set in that channel is used.
  178.  
  179. Sample loading
  180. ==============
  181. Because  many  people  have  hundreds/thousands of samples, spread over many
  182. different disks/directories, the samples have to be organized some way.  MED
  183. handles  the organization using a file "MED_paths" (path file).  It contains
  184. the  name  of the directory, names of the samples in that directory, name of
  185. another directory...and so on.  This way MED knows what samples each of your
  186. sample  disks/directories  contain  and can load samples from correct disks.
  187. The  path  file is loaded when starting up MED and it must be located in the
  188. current  directory  or  S:-directory.   This  file can be produced with text
  189. editor,  but it is easier to do it with MED.  Detailed instructions later in
  190. this manual.
  191.  
  192. Note
  193. ====
  194. The note and the numbers:
  195.  
  196.                 command
  197.                    |
  198.          D # 3   5 1 0 F
  199.            |     |   \ |
  200.          note    |    \|
  201.          instrument #  data byte (more information about command)
  202.  
  203. "note" is the note to be played (or "---" for no note)
  204. "instrument #" is the number of the instrument (01 - 1V). The leading
  205.                zero is displayed as a space. The number can also be 0.
  206.                It means that the note is played with same instrument
  207.                number and with same volume as previous note in that
  208.                track.
  209. "command" is the number of command/effect to play. If there are no
  210.           effect or commands, command nibble and data byte are zero.
  211. "data byte" gives more information about command/effect to the player.
  212.  
  213. Effects/commands are documented later...
  214.  
  215. The  numbers  can  be  changed  simply  with positioning the cursor over the
  216. number  to  be changed and typing the new number.  If you have to change the
  217. 5th  number (between the note and the other numbers:  C-212000), which means
  218. that  sample  10  -  1V  is  used, position the cursor over the first number
  219. that's  always  visible  (the  second  '2' in above example), hold Shift and
  220. enter  the  1st  number.  For example, to change instr.  number to 1E, press
  221. Shift-E.   Because  Shift-0  -  9 have other use, press Amiga-Shift-0 - 9 to
  222. change  the  instr.  number to 10 - 19.  This is not very handy, but because
  223. there  won't  probably  be a lot of songs which have over 31 instruments, it
  224. doesn't matter very much.
  225.  
  226. Prompts
  227. =======
  228. MED  often  (especially  during file operations) wants to ask you something.
  229. For this purpose MED displays a line of text on the title bar e.g.
  230.  
  231.     Remap instruments (Y/N)?
  232.  
  233. You  always  answer to these questions with keyboard, in this case you would
  234. press  'Y'  for  a  positive, and 'N' for a negative answer.  If you want to
  235. cancel the operation (loading, saving...), you can usually press 'Esc' to do
  236. that.
  237.  
  238. Multiple songs
  239. ==============
  240. MED  can  have  more  than one song in memory at a time.  However, all songs
  241. share the same set of instruments.  This allows you to, for example, compose
  242. different songs for each level of a game, without having to load or keep the
  243. same instrument in memory more than once.
  244.  
  245. On the status bar there are two gadgets which control this feature (see the
  246. description of the status bar above).
  247.  
  248. If  you  click  the right gadget (assuming you've just booted MED), MED will
  249. request  "Add  new  song  (Y/N)?".   If  you  answer 'Y', a new song will be
  250. created.  You can now move from song 1 to song 2 with these gadgets.  If you
  251. want  to delete the last song, press the left gadget while holding the Shift
  252. key.  Again, MED will request you before proceeding.
  253.  
  254. Note:  If you want to add a new song without the prompt, you can hold Shift
  255.        while clicking the right song selection gadget.
  256.  
  257. MED  can  automatically remap instruments while loading.  This feature saves
  258. you  from  a lot of work.  For example, you have one song in memory, and you
  259. add  another (by clicking the right song selection gadget).  If you now load
  260. a  second  song from disk, MED will ask:  "Remap instrument (Y/N)?".  If you
  261. reply  'N', all previous instruments will be lost and the instruments of the
  262. new  song  will  be  loaded.   But if you reply 'Y', some magic will happen.
  263. First,  the  instruments  of  the  new  song  will be loaded to empty slots,
  264. instruments  already  in  memory  will be preserved.  Second, the instrument
  265. numbers of the loaded song will be remapped so that they point to new places
  266. of the instruments.
  267.  
  268. Sometimes,  when there are unused instruments in memory, MED will ask if you
  269. want  to flush them.  This can happen when you Clear the song, or load a new
  270. song (replacing another).
  271.  
  272. You  can  also  save  all  the songs as a single multi-module.  You have to
  273. select  "Module" in the save format requester, and answer 'N' at "Save only
  274. current  song"  prompt.   If you select 'Y', only the current song is saved
  275. (unused instruments won't be saved).
  276.  
  277. To get rid of all the songs/instruments, click "Clear all" on Misc panel.
  278.  
  279.  =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  280.  ***************************************************************************
  281.  *                                                                         *
  282.  *  +-------------------------------------------------------------------+  *
  283.  *  |                     Summary of the features                       |  *
  284.  *  +-------------------------------------------------------------------+  *
  285.  *                                                                         *
  286.  ***************************************************************************
  287.  =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  288.  
  289. +=========================================================+
  290. |           Files
  291. +=========================================================+
  292. This  panel  contains  the tools you need when handling files.  You can save
  293. and load with many different formats and also delete them.
  294.  
  295. First  of  all,  there's  a file requester.  There should be no difficulties
  296. with  using it.  It is simple, but it works.  Directory names are printed in
  297. white  and files in black.  There are three gadgets that allow you to choose
  298. what  is  displayed  in the requester.  If the Currdir is selected, files in
  299. the  current directory are displayed.  Devices lists all devices e.g.  DF0:,
  300. DF1:,  DH0:   etc..   Assign  lists  all assigned directories (e.g.  C:, S:,
  301. FONTS:).  You can also load a directory by typing its name on the Dir-gadget
  302. (and  pressing  Return).
  303.  
  304. The  File-gadget  contains the filename.  If you know already the filename,
  305. you  can ignore the file requester and type the filename (with correct path
  306. from the startup directory).
  307.  
  308. ------- Load
  309. Song:       This is the gadget used to load songs. Loads songs
  310.             with following formats:
  311.                   MED V1.12 - V3.20,
  312.                   OctaMED V1.00 - V2.00 (only 4 channels can be played)
  313.                   MMD0 (MED modules), SoundFX/old SoundTrackers.
  314.             The samples are automatically loaded after the song.
  315.             WARNING: Don't try to load anything as a song!!!
  316.             If MED can't identify the file, it is loaded as an old
  317.             SoundTracker file. If it is an old SoundTracker file, it
  318.             should load well, but if it isn't, you may meet the GURU!!!!
  319.             MED can't load packed SoundTracker/NoiseTracker files. To
  320.             import songs, save them as modules, then load into MED with
  321.             "ST MOD". MED also recognizes Noise/Protracker modules
  322.             and prompts if you want to load it as a such (usually you should
  323.             answer 'Y').
  324.  
  325. Instr:      Loads the sample. The title bar will display the length of
  326.             the sample if it loaded ok. This will load synthsounds and
  327.             hybridsounds as well.
  328.  
  329. ST MOD:     With this gadget you can load 31-instrument Sound/Noise/Pro-
  330.             tracker modules. There are some differences between MED's and
  331.             Tracker's commands, they're converted automatically.
  332.  
  333. ------- Save
  334. Song:       When you choose this one, a requester appears and asks you to
  335.             select the save format. The save formats are described a couple
  336.             of lines later. There's also "Icon" gadget. When it is selected,
  337.             MED will create an icon file when saving Song or Sng+samples.
  338.             If you don't need the icon, turn it off to save some disk
  339.             space.
  340.  
  341. Instr:      Saves the current sample/synthsound/hybrid sound. If you want
  342.             to save samples in IFF-format, set the switch in sample editor.
  343.  
  344. Delete:     Deletes the file. MED requests if you really want to delete
  345.             it.
  346.  
  347. ======= Save formats
  348.  
  349. There are several different file formats available:
  350.  
  351. Song     This is the normal song, which you will probably use most often.
  352.          The song is saved using a highly-compressing file format. The
  353.          samples are not saved. They are loaded from your instrument disk(s)
  354.          using the path list (or absolute paths if instrument names are e.g.
  355.          ST-01:Ringpiano).
  356.  
  357. Sng+samples
  358.          Saves the song like the previous one, but also attaches the
  359.          samples to the end of the file. The result is one big file which
  360.          contains everything needed. This format makes usually a bit
  361.          shorter files than Module, but I recommend that you now save
  362.          your songs as a module, at least if they'll be distributed.
  363.  
  364. Module (MMD0)
  365.          This is the most flexible file format, which allows you to save
  366.          all song information, like Sng+samples, but this format is most
  367.          likely understood by external programs, because Sng+samples is
  368.          quite tricky to load and use. Also, multiple songs can be saved in
  369.          one module. In general, files saved in this format are longer than
  370.          Sng+samples files.
  371.  
  372.          When you save a module, you'll be asked "Save instrument names etc".
  373.          If you answer 'Y', all data is saved. Otherwise only the data
  374.          required for playing the song is saved. The copyright/annotation
  375.          text is always saved.
  376.  
  377. ST-Module
  378.          If you want to export music to Sound/Noise/Protracker,
  379.          you can use this gadget to save the song as a module.
  380.          NOTE: Because there are many things in MED that are not supported
  381.                by Trackers, some information may be lost:
  382.                - samples 10 - 1V won't work
  383.                - only 4 tracks saved, no MIDI support
  384.                - blocks longer than 64 lines will be truncated to 64 lines
  385.                - no color or pointer jump information
  386.                - no relative volume settings, no play/instrument transpose
  387.                - no hold/decay
  388.                - no support for synthsound/hybrid sounds
  389.          NOTE 2: The resulted file will be a 31-instrument module. If you
  390.                  try to use it with programs supporting only old modules,
  391.                  it'll most likely fail.
  392.  
  393. +=========================================================+
  394. |            Play
  395. +=========================================================+
  396. This  is  a very important panel.  Here you can control the playing, set the
  397. playback speed (tempo), handle the playseq list...
  398.  
  399. Beginning from the left, there is a tall box which contains numbers "00" if
  400. there's  no  song  in  memory.   This  is a window to the playseq list.  As
  401. mentioned above, the playseq list is the list of blocks to be played.  This
  402. window  show  5  numbers  of  the list at a time.  There are gadgets on the
  403. right side of the box which scroll the list up/down/beginning/end.
  404.  
  405. The keyboard equivalent is to hold down the Ctrl-key and then press number 8
  406. from  numeric  keypad  to  scroll  up,  2  to  scroll  down, 7 (home) to the
  407. beginning, 1 (end) to the end.
  408.  
  409. On the right side of the scroll gadgets are the following gadgets:
  410.          +   -   Ins   Del   Ins (with small arrow pointing down)
  411.  
  412.          +      increases the current playseq number (Ctrl - keypad 6)
  413.          -      decreases the playseq number (Ctrl - keypad 4)
  414.          Ins    inserts a new sequence number (zero) under the cursor
  415.                 (Ctrl - keypad 0 (Ins))
  416.          Del    deletes the current sequence number (Ctrl - keypad . (Del))
  417.          Ins (w/arrow) inserts a new sequence number, the new number
  418.                 will be the number of current block (Ctrl - keypad 5)
  419.  
  420. ------- Controlling the playing
  421.  
  422. Play song       starts playing the song from the beginning.
  423. Continue song   starts playing from the current playseq entry and cursor pos.
  424. Play block      plays the current block (starts from the beginning).
  425. "D" (next to Play Block) starts playing block when you enter a note (editing
  426.                 must be on).
  427. Continue block  starts playing the current block from the cursor position.
  428. Stop playing    stops playing the song. You can also use it to kill the
  429.                 notes played from the Amiga/MIDI keyboard.
  430.  
  431. The shortcuts of these commands:
  432. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  433. Stop playing    press just Space
  434. Play song       press Space with Alt+Shift held down
  435. Continue song   press Space with Shift down
  436. Continue block  press Space with Alt held down
  437. Play block      no shortcut, sorry.
  438.  
  439. ------- Tempo (playing speed)
  440.  
  441. To understand this completely, you need to know some technical aspects.  MED
  442. uses the CIAB timers for timing.  They give "timing pulses" that trigger the
  443. MED's  player  interrupt.   On  each  timing pulse effects are handled (e.g.
  444. commands  1,2,3,4,5,D, hold/decay, synthsounds), but new note is usually not
  445. played  on  each  pulse.   The  time  between  timing  pulses can be changed
  446. (primary  tempo).   The  new  note is usually played on every 6th pulse, but
  447. this  can  be  changed  too  (secondary tempo), for example, if new note was
  448. played  on  every 3th pulse, the playing speed would be twice as fast.  This
  449. doesn't affect the speed of effects.
  450.  
  451. Graphically:
  452. pulse   \         PLAY NOTE
  453.          the time between pulses can be changed (primary tempo)
  454. pulse   /         DO EFFECTS  \
  455.                                \
  456. pulse             DO EFFECTS    \ The number of pulses between
  457.                                 / notes can be changed (4 in this example).
  458. pulse             DO EFFECTS   /  This is the secondary tempo.
  459.                               /
  460. pulse             PLAY NOTE
  461. ...
  462.  
  463. The left proportional gadget controls the primary tempo.  It can be 1 - 240.
  464. The  bigger  the  number, the faster the speed.  Note that tempos 1 - 10 are
  465. Tracker-compatible (but obsolete, because secondary tempo can be used now).
  466.  
  467. The  right one controls the secondary tempo (default = 6).  It can be 1 - 20
  468. (note:   hexadecimal!!).   The  lower,  the faster.  This allows quite rough
  469. setting of playing speed (it's the way NoiseTracker etc.  set their tempos).
  470. In MIDI use (especially for syncing), you should leave this to 6 and use the
  471. primary tempo instead.
  472.  
  473. LP-Filter       with this gadget you can turn on/off the audio filter
  474.                 built into your Amiga. When this gadget is selected
  475.                 and the power-LED is bright, the filter is on. If
  476.                 the LED is dim, the filter is off. You probably want
  477.                 to keep it off.
  478.                 The state of this switch will be saved with songs.
  479.  
  480.         NOTE: With Amiga 1000's, it's not possible
  481.                 to turn off the filter without modifications to the
  482.                 computer. Please keep the filter off.
  483.  
  484. E1, E2, E3      If you've played something with MED, you have found the
  485.                 three "equalizers" (in fact, they are not equalizers, but
  486.                 I'll use this word, because many others do so too...)
  487.                 E1 turns off/on the red bars at the bottom of the screen
  488.                 (PAL machines only). E2 turns off/on the four colorful
  489.                 sprites. E3 turns off/on the signal "oscilloscope" displays.
  490.  
  491.                 These all are turned off to save processor time when
  492.                 you click the right mouse button to show the title bar,
  493.                 but if you want to disable something, it probably is E3.
  494.                 The signal display eats lots of the processor time (on
  495.                 standard 68000). Because of that, the display is turned
  496.                 off during disk access to speed loading/saving. You may
  497.                 want to keep E3 disabled all the time.
  498.  
  499. STS             Normally effects are done on every timing pulse (see above).
  500.                 When this switch is on, the effects are NOT done on the
  501.                 first pulse (when the note is played). This is the way the
  502.                 Trackers do that, and this switch is for compatibility only.
  503.  
  504. V: Hex/Dec      This is another compability switch. While the data bytes
  505.                 of the commands are usually hex numbers, it's possible to
  506.                 use the volume-command with hex or decimal argument.
  507.                 When Hex is selected, the acceptable volumes are 00 - 40.
  508.                 When Dec is selected, the volume can be 00 - 64.
  509.                 If you are not a programmer (and even if you are), it may
  510.                 be easier to think the numbers in decimal. It is the
  511.                 default.
  512.                 The state of this switch will be saved with songs.
  513.  
  514.                 You can easily convert all volume commands from decimal to
  515.                 hex and vice versa. If Dec is selected and you click Hex
  516.                 while holding the Shift key down, automatic conversion is
  517.                 done (works on the same way to the opposite direction too).
  518.  
  519.                 I recommend using Hex volumes whenever possible. It is
  520.                 slightly faster (not noticeably, but faster anyway).
  521.  
  522. Channels 4 5 6 7 8
  523.                 These are the channel configuration selection gadgets of
  524.                 OctaMED. On MED, they just don't work.
  525.  
  526. ------- Panic stop
  527. It's  possible  to  make  a song, which takes all of the processor time.  It
  528. will therefore be impossible to stop it.  This shouldn't happen accidentally,
  529. but  if  you  fill  a block with notes and command FF3 and set tempo to 240,
  530. you'll  get the idea.  To stop playing in this case, hold both mouse buttons
  531. down about 5 - 6 seconds.
  532.  
  533. +=========================================================+
  534. |           Instr
  535. +=========================================================+
  536.  
  537. Here  you can load samples and alter some characteristics of them.  First I
  538. should note out some important actions which are available on the keyboard:
  539.     Shift-Cursor Left/Right = select previous/next sample
  540.     Shift-Alt-Cursor L/R    = 16 samples forward/backwards
  541.     Amiga-I                 = activate sample name gadget
  542.     Shift-Amiga-I           = clear and activate sample name gadget
  543.     Amiga-R                 = activate repeat gadget
  544.     Amiga-J                 = jump on/off
  545.  
  546. At the top left corner of this panel is the sample number (01 - 1V) followed
  547. by  the sample name gadget followed by the length of current sample in bytes
  548. ("-" if no sample loaded).
  549.  
  550. To  load  a  sample, you can write the name of it in the string gadget, then
  551. click "^ Load Sample ^" (or just press Return).
  552.  
  553. Above  the  Load Sample gadget are gadgets that select first, previous, next
  554. or  last  sample.   L.U.   (Last  Used)  selects  the last sample that is in
  555. memory.
  556.  
  557. On  the  left side of them are two gadgets ("Jump", "Flush").  "Jump" causes
  558. jumping when this instrument is played. "Flush" removes this instrument.  It
  559. frees  the  memory  used  by  it  (handy when you're very low on memory) and
  560. clears all the values.  Jumpings will be saved with songs.
  561.  
  562. "Transpose"  is  one  of  the  new  features  of V2.10.  It works like "Play
  563. transpose"  but  only  for  this  instrument.  So, if "Transpose" is -2, for
  564. example, then this instrument is played two halfsteps lower.
  565.  
  566. Repeat  means  that when you play a note with some instrument, the note will
  567. play  forever,  until  you  play a new note.  A picture tells more than 1000
  568. words:
  569.  
  570.          the beginning              repeat start offset           the end
  571.          v                                v                             v
  572. Sample:    | This part is played only once  | This part is looped forever | |
  573.  
  574.          \__________repeat_______________/ \________repeat length______/
  575.  
  576. "Repeat" is the length of the part which is played only once (in bytes).
  577. "Repeat length" is the length of the part which is played forever (also
  578. in bytes).
  579.  
  580. When  you load IFF-instruments, these values are automatically loaded.  They
  581. can  be also set in path file, so that when you load a sample, you will also
  582. get  the  repeat values.  Gadget REP/BEG is the repeat start offset, REP/LEN
  583. is the length.  If the repeat length is lower than 4, no repeat will occur.
  584.  
  585. The  big  proportional  gadget  controls  the  default volume of the current
  586. instrument:   64  =  maximum,  0  =  silent.  It's displayed in both hex and
  587. decimal.
  588.  
  589. ------- Hld/Dec (Hold/Decay)
  590. (again a thing, that is difficult to explain...)
  591. With  Hold,  you  can set the exact duration of the note (in timing pulses).
  592. The  note  is  then turned off (if decay is 0) or decay is started.  In this
  593. example,  I  assume  that  the  secondary tempo is 6 (one line is one timing
  594. pulse)
  595.  
  596. 1. no hold
  597.  
  598. 0 PLAY+fx C-2 1000 <= play note
  599. 1 fx
  600. 2 fx
  601. 3 fx
  602. 4 fx
  603. 5 fx
  604. 0 PLAY+fx D-3 1000 <= stop previous and play new
  605. 1 fx
  606. ...
  607.  
  608. 2. with hold set to '2'
  609.  
  610. 0 PLAY+fx C-2 1000 <= play note
  611. 1 fx
  612. 2 STOP+fx          <= stop it
  613. 3 fx
  614. 4 fx    (silence here)
  615. 5 fx
  616. 0 PLAY+fx D-3 1000 <= play new note
  617.  
  618. In  example  1,  (without  hold)  you can set the note duration only roughly
  619. (accuracy  of 6 timing pulses).  In example 2, the note duration is only two
  620. timing pulses (because hold = 2).
  621.  
  622. So,  this  allows  a  powerful definition of note length, but it can't be
  623. used with long notes, because the note stops immediately??  Wrong!!
  624.  
  625. Look at this:
  626.  
  627. 000 C-2 1000               / line# pulse# action
  628. 001 -|- 1000              /   003    0    continue note...
  629. 002 -|- 1000             /    003    1    continue note...
  630. 003 -|- 1000 => ZOOMED =>     003    2    STOP NOTE
  631. 004 --- 0000             \    003    3    (silence)
  632. 005 D-3 1000              \   003    4    (silence)
  633. ...
  634.  
  635. So,  the keep holding -symbol (-|-) allows you to make the note longer.  The
  636. keep  holding  -symbol  can  be entered by clearing the note and setting the
  637. instrument number only, or easier:  by pressing Return.
  638.  
  639. If  the  decay  is  0, the note is turned off immediately after the stopping
  640. point.   You  can  set  the  decay  to  happen as well (1 = slowest).  Decay
  641. doesn't work with MIDI-instruments.
  642.  
  643. If  you're  using synthsounds or hybrid sounds, see Synthsounds.doc, because
  644. the decay is handled quite differently with them.
  645.  
  646. The  hold/decay  is  a quite useful feature, so I recommend you learn to use
  647. it!!  (Thanks to ZAP for suggesting me this feature!!)
  648.  
  649. +=========================================================+
  650. |           Block
  651. +=========================================================+
  652. This  panel  contains  most  of  the  block  handling  things  and  the copy
  653. operations.
  654.  
  655. Trk: Cut Copy Paste Swap
  656.          These gadgets are used to cut/copy/paste tracks. Swap swaps
  657.          the contents of the copy buffer and current track.
  658.          The keyboard shortcuts for Cut/Copy/Paste are:
  659.                 Amiga-X, Amiga-C, Amiga-V
  660.  
  661. Blk:  Cut Copy Paste Swap
  662.          These work just like the previous, they just affect the entire
  663.          block. The keyboard shortcuts are also just like the previous
  664.          except hold down the Shift key too (Amiga-Shift-X...).
  665.  
  666. Del buff
  667.          When you don't need the contents of the buffer any more, you
  668.          can click this gadget to free the memory allocated for the buffer.
  669.          It's useful when you're very low on memory. The buffer is freed
  670.          automatically when you exit, so you may not need this gadget
  671.          at all.
  672.  
  673. Then there are the block commands.
  674.  
  675. Trks: 4 8 12 16
  676.          You can select how many tracks you want this block to have.
  677.          Note that tracks 4 - F can be used only with MIDI devices.
  678.          Note also that when you decrease the number of tracks, the
  679.          higher tracks will be lost (no Are you sure? requesters).
  680.  
  681. Lines: 64 < > « »
  682.          These gadgets are used for selecting the number of lines in
  683.          this block. « » gadgets increase/decrease the number by 10,
  684.          < > gadget by 1. The preferred way is to write the number
  685.          directly into the string gadget (less memory fragmentation).
  686.  
  687. 1 2 3 4 8 16 C
  688.          It may be helpful for easier positioning of notes to be able to
  689.          "mark" lines some way (especially if the block is long). You
  690.          can make some lines appear with reversed colors, if you want.
  691.          1 highlight every line, 2 highlights every other line, 3 high-
  692.          lights every third line and so on. C clears all highlighting from
  693.          this block. You can also mark individual lines with TAB-key.
  694.          The highlighting can be removed by highlighting the line(s) again.
  695.          The highlightings are saved with songs.
  696.  
  697. New block
  698.          This gadget creates a new block after the last block. The new
  699.          block will have the same number of tracks and lines as the
  700.          current block.
  701. DEF      This is the same as 'New block' except that the block length
  702.          is always set to 64 and the number of tracks to four (eight,
  703.          if you're in 5 - 8 channel mode).
  704.  
  705. New here
  706.          Creates a new block here, shifts all following blocks forward.
  707.          The playseq numbers are corrected so that the song won't change.
  708. DEF      Uses default length/number of tracks, see DEF definition above.
  709.  
  710. Del last
  711.          Deletes the last block (no warning messages, be careful).
  712.  
  713. Del this
  714.          Deletes the current block. Playseq numbers corrected.
  715.  
  716. Split    Splits the current block so that the current line will be the
  717.          first line of the next block.
  718.  
  719. Join     Joins this block and the following block together.
  720.  
  721. Ins.L.   Inserts an empty line under the cursor. The block length is
  722.          increased by one and the notes are shifted one step forward.
  723.  
  724. Del.L.   Deletes the current line. Block length is decreased and the lines
  725.          are shifted backwards.
  726.  
  727. Ins.Trk  Inserts a new track. The subsequent tracks are shifted one step to
  728.          right, and the rightmost track is lost.
  729.  
  730. Del.Trk  Deletes current track, and the subsequent tracks are shifted to
  731.          left one step.
  732.  
  733. Expand   When you have created a nice-sounding block, but you would like
  734.          to include e.g. some fast rhythm patterns, but you notice that
  735.          the block plays too slowly for the patterns. "Expand" changes
  736.          the size of the block and creates empty lines between notes.
  737.          Now you can increase the tempo and insert the rhythm patterns.
  738.  
  739.          NOTE: The maximum length of the expanded block may not be greater
  740.          than 256 lines. In that case, you'll get a warning, and expansion
  741.          is not done. Also, if you want to make fast rhythm patterns, see
  742.          first instructions for commands FF1, FF2, FF3. They may be an
  743.          easier way.
  744.  
  745. Shrink   When you have expanded the block, you can return it to the
  746.          original state by pressing shrink. This function exists for
  747.          symmetry. It has not much real use.
  748.  
  749. The number gadget between these two gadgets is the amount of expanding.
  750. E.g. 2 doubles the length (inserts one empty line between each note).
  751. 3 would triple the length, and so on.
  752.  
  753. +=========================================================+
  754. |           Edit
  755. +=========================================================+
  756. Edit-panel contains functions that help editing.
  757.  
  758. On:             These are the switches that allow you to switch temporarily
  759.                 any track off and back on. The 16 lights in the status bar
  760.                 show you which tracks are on, when you're not using the
  761.                 Edit panel. ST sets all tracks on, CL sets all tracks off.
  762.  
  763. Edit and SPC    at the right corner are the bigger equivalents of
  764.                 "E" and "SP" in the status bar. "Edit" turns editing
  765.                 on/off and SPC turns on/off extra spacing between notes.
  766.                 You can type the space value in the string gadget next
  767.                 to the SPC-gadget (1 - 16). When you enter notes during
  768.                 playing (in real time) with SPC on, the notes will be
  769.                 quantized e.g. if SPC = 2, the notes will be placed only
  770.                 on even-numbered lines.
  771.                 Keyboard: Edit on/off = Esc, SPC = ~ (below ESC)
  772.  
  773. 1+2, 2+3, 3+4, 4+5 on the left corner select the keyboard octaves which
  774.                 are used. This can be done also with F1 - F4 keys.
  775.  
  776.  
  777. ------- Programmable keys
  778. It's  possible  to assign 10 different notes/commands to number 0 - 9.  Then
  779. you  can  insert  the  note/command  with Shift- 0 - 9.  You can also assign
  780. commands to Left and Right Alt.  When you then enter notes, holding down the
  781. Alt,  command is inserted to the note.  The programmable keys are especially
  782. useful when entering drum-rhythms etc.  The definitions can be saved so that
  783. they're automatically loaded when you start MED next time.
  784.  
  785. It's  also possible to pick up a range of notes (they can't be edited after
  786. picking).
  787.  
  788. "Edit"-panel  contains  gadgets,  which  you can use to edit the notes/cmds.
  789. Only one note/cmd of the 12 is displayed at a time.
  790.  
  791. 0-9      Shows the current 'Shift-number key' definition, the number is
  792.          shown above the arrow gadgets, which can be used to change it.
  793.  
  794. L.Alt    Shows the definition of Left Alt
  795.  
  796. R.Alt    Shows the definition of Right Alt
  797.  
  798. The current definition of each key is displayed on the Edit-panel. If some
  799. number is marked as "x", it's "transparent", the existing number will not
  800. be changed when the note is entered to the block (with Shift 0 - 9).
  801.  
  802. You can change the definition by picking a note, but you can change it in
  803. another  way  as  well.   Click  the  number to be changed, and enter a new
  804. number from keyboard while still holding the mouse button, and pointing the
  805. number  to  be  changed.   If you want to change several numbers, you don't
  806. have  to  release  the button.  Just position the mouse over the number you
  807. want to change.
  808.  
  809. For  example, if you wanted to clear all commands from this track (but leave
  810. the notes) you could make a following definition:
  811.  
  812.          xxx  xx000
  813.  
  814. Because  the  note  is  "xxx"  and  instrument number is "xx", they won't be
  815. changed,  and  only the command is cleared.  Then you can just hold down the
  816. Shift and the number key and let the key-repeat do the job.
  817.  
  818. R.Alt  and  L.Alt  are a bit different:  the note number is always "xxx" and
  819. the instrument number by default is "xx".
  820.  
  821. Pick note
  822.        copies the note currently under the cursor to this key. You can
  823.        also pick, for example #7 by pressing Shift-Ctrl-7.
  824. Pick range
  825.        picks the current range as a definition of this key
  826. Pick buf
  827.        picks the copy buffer as a definition of this key
  828. Clr    clears the definition of this key.
  829.  
  830. SPACE=DEL
  831.        Some people may prefer using the space bar instead of DEL when
  832.        entering blank notes. This switch makes it possible.
  833.  
  834. Keypad: Track on/off / Sel.instr
  835.        This allows you to set the keypad operating mode. When it's set
  836.        to "Track on/off", the keypad can be used to turn tracks 0 - F
  837.        on/off. When "Sel.instr" is selected, you can select quickly the
  838.        first 16 instruments. The layout is as follows:
  839.         [ = 0  ] = 1  / = 2  * = 3
  840.         7 = 4  8 = 5  9 = 6  - = 7
  841.         4 = 8  5 = 9  6 = 10 + = 11
  842.         1 = 12 2 = 13 3 = 14 . = 15
  843.  
  844. Advance
  845.         Here are some quite useful editing options, that control the
  846.         automatic advancing of the cursor after entering something.
  847.  
  848.         (down arrow)  When this is selected, the cursor automatically
  849.                       moves to the next line when a note is entered.
  850.                       Shortcut: Ctrl-A
  851.         (up arrow)    Moves the cursor to the previous line, when note
  852.                       entered. This is probably not very useful (but
  853.                       interesting...)
  854.         >             When entering effect numbers, the cursor is moved
  855.                       to right (but not to next line).
  856.         <             When entering numbers, the cursor moves to left.
  857.                       (again, not too useful...)
  858.         >>            When entering notes, the cursor is moved to the next
  859.                       track.
  860.         <<            When entering notes, cursor is moved to the previous
  861.                       track.
  862.  
  863. +=========================================================+
  864. |           Misc
  865. +=========================================================+
  866. Some  miscellaneous and not very important things and a VERY important thing
  867. (quitting).
  868.  
  869. On  the  left  there are gadgets for changing the screen colors.  No need to
  870. explain??   All right, I won't.  But just remember that the colors are saved
  871. when you save your song (they can give some "feel and expression").  You can
  872. also set the default colors of MED by clicking Save prefs.
  873.  
  874. Jumping: Off 8th Smp
  875.          When you don't want to see the "funny" mouse pointer, select Off.
  876.          When you want him to jump every 8th note, select 8th.
  877.          When you want him to jump when some sample is played, select
  878.          Smp. The instruments which cause him to jump are selected from
  879.          "Instr"-panel (gadget name: Jump).
  880.  
  881.          The name of the pointer is Topi (according to my cousin).
  882.  
  883. Clear All, Clear song only, Quit
  884.          These are very dangerous functions, in fact they're so dangerous
  885.          that you must click 'Confirm' after you've selected one of them:
  886.  
  887.          "Clear All" does just as it says. Clears the song, removes all
  888.          instruments from memory. In two words: clears everything.
  889.          Note: This clears ALL songs.
  890.  
  891.          "Clear song only" is not as destructive. While it destroys the
  892.          song, it leaves the instruments (if you want to create a new
  893.          song without reloading the instruments).
  894.          Note: This clears only the current song.
  895.  
  896.          "Quit" is the most destructive. It does everything "Clear
  897.          All" does, but even worse, it quits MED!!!!!!
  898.          This function was made for program testing and it probably
  899.          doesn't have any real use ;-)
  900.  
  901. Paths: Add/Rem
  902.          These affect the sample names when loading songs/samples.
  903.  
  904.           Add        Adds the complete path of the sample when you
  905.                      load e.g. if you load sample "PopSnare2" from
  906.                      "ST-01:", the sample name will be "ST-01:PopSnare2".
  907.  
  908.           Rem        Usually songs made with Trackers have sample names
  909.                      like "ST-02:AhhVox". If you want that the samples are
  910.                      loaded using the path list instead of absolute names
  911.                      (if your samples are in hard disk, for example) you
  912.                      can remove "ST-xx:" from sample names and reload them,
  913.                      but when you "Rem paths" is selected, any paths before
  914.                      the sample names are removed quickly and easily during
  915.                      loading.
  916.  
  917.          Both of these can be active at the same time. In that case the
  918.          original path is removed, instrument is loaded using the path list,
  919.          and the path name from the path list will be added.
  920.          Note that the maximum length of a instrument name is 39 chars,
  921.          so if the path name is very long, something may be lost.
  922.  
  923. H->B:
  924.          This selects the name of the note between A# and C.
  925.          In some countries, it's H. In some other countries it's B.
  926.  
  927. WB: Open/Close
  928.          These gadgets allow you to easily close/reopen the Workbench
  929.          screen to give you extra memory space.
  930.  
  931. Save prefs
  932.          This will save the default settings of MED to S:med.config.
  933.          When you start MED next time, these settings will be loaded.
  934.          The following things will be saved:
  935.                 Current screen colors as default colors
  936.                 H->B
  937.                 State of E1, E2 and E3 switches
  938.                 Screen depth (Dep2)
  939.                 NO16
  940.                 Space = Del
  941.                 Keypad mode
  942.                 Automatic advance settings
  943.                 Current programmable key definitions
  944.                 Jump: Off
  945.                 PTKey
  946.  
  947. Dep2    This changes the screen depth from 8-colors to 4 colors. This
  948.         frees some chip memory, but most important: it releases lots of
  949.         DMA-time. In plain English: MED will run faster (but looks
  950.         less pretty).
  951.  
  952. NO16    This gadget disables the 12/16 track display on OctaMED. On MED,
  953.         it does nothing.
  954.  
  955. PTKEY   This switch changes the keyboard operation so, that the most common
  956.         Protracker keyboard options will be recognized. This is helpful for
  957.         those who have got used to Protracker keyboard layout. The following
  958.         PT shortcuts are recognized:
  959.  
  960.         Right shift     Turns editing on, starts playing the block (= record)
  961.         Right alt       Continue song
  962.         Right Amiga     Play block
  963.         L-Alt+curs.L/R  Previous/next block
  964.         Shift+curs.L/R  Increase/decrease playseq position
  965.         Space           Stops playing/toggles editing.
  966.         TAB             Next track
  967.         Shift-TAB       Previous track
  968.         Shift-F3 - F5   Cut/Copy/Paste track
  969.         Alt-F3 - F5     Cut/Copy/Paste block
  970.  
  971.         If there are any other Protracker options you'd like MED to recognize,
  972.         please let me (Teijo) know.
  973.  
  974. +=========================================================+
  975. |         Vol
  976. +=========================================================+
  977.  
  978. This  panel  allows  you  to  set the proportional volume of each track.  In
  979. addition  you can also set the master volume.  The proportional value can be
  980. 1  -  64.   If both the master volume and the volume of a track are 64, that
  981. track  is  played  on  full volume.  If the master volume was 32 and a track
  982. volume was 32, the volume of that track would be 1/4 of the full volume.
  983.  
  984. There  are  two  sets  of  «  < 64 > » gadgets.  The one on the right is the
  985. master  volume.  The left one changes the volume of the selected track.  You
  986. can select the track, by clicking a number above the gadgets.  The currently
  987. selected number is highlighted.
  988.  
  989. This  is  quite  easy,  so no problems should appear.  The track volumes and
  990. the master volume are saved with songs.
  991.  
  992. +=========================================================+
  993. |           MIDI
  994. +=========================================================+
  995. MED  can output notes and some commands to external MIDI-devices (keyboards,
  996. synthesizers...).   The  MIDI-panel  contains the MIDI-stuff which is needed
  997. for that.
  998.  
  999. When you decide that some instrument should be a MIDI-instrument, you select
  1000. the  MIDI  channel  for  it.   "MIDI  ch"-gadgets are used for that.  If you
  1001. select e.g.  MIDI channel 2, the notes of the current instrument are sent in
  1002. MIDI  channel  2  (simple,  isn't  it?).  Remember to set the default volume
  1003. (Sample panel).
  1004.  
  1005. Also,  you  need to activate MIDI (click "MIDI active").  If the serial port
  1006. is  used by some other program, you can't use MIDI.  Then you must terminate
  1007. the other program and try again.
  1008.  
  1009. After  you have activated MIDI, MED starts sending "active sensing" messages
  1010. ($FE).  Active sensing can be turned off with the "Act.sensing"-gadget.
  1011.  
  1012. By  default  MED uses the default preset of that channel (which you have set
  1013. on your MIDI device).  If you want to use other presets, you can select them
  1014. using  the "MIDI pres #"-gadgets, in that case the program change message is
  1015. transmitted  when  a note is played.  Preset number 0 means that the default
  1016. preset  is  used  (the preset is never changed for this instrument).  If you
  1017. want to send a preset change command, but don't want to play a note yet, use
  1018. the  command  C00  with any note.  In that case, the preset will be changed,
  1019. but no note will be transmitted.
  1020.  
  1021. You  can have instruments with differents preset numbers, but which will use
  1022. the  same  MIDI  channel.   In  that  case,  MED will automatically send the
  1023. program  change message whenever the instrument with different preset number
  1024. is used.
  1025.  
  1026. You can use MIDI-instruments on all 16 tracks (if there are 16 tracks on the
  1027. current block).  You can also freely mix samples and MIDI-instruments on the
  1028. same track (tracks 0 - 3 only).
  1029.  
  1030. One  helpful  keyboard  command  is  Ctrl-Space.  This command resets pitch-
  1031. benders  and  modulation  wheels on all channels.  Also, if you have changed
  1032. presets  on  your  MIDI-device,  MED  can't  detect this and thinks that the
  1033. preset  is  not  changed.   Ctrl-Space  causes  MED to resend program change
  1034. commands for all channels, when playing.  There's a gadget:  "Reset pb+pres"
  1035. that does the same thing.
  1036.  
  1037. The "MIDI reset"-gadget sends a MIDI reset command ($FF).
  1038.  
  1039. If  you  turn "Send sync" on, MED will send MIDI sync information, and allow
  1040. other  devices  to  synchronize with MED.  When "Ext sync" is on, MED can be
  1041. synced  externally.  You must also have input active when this is turned on.
  1042. The  synchronization  works  only  when you play song, when you're playing a
  1043. single block, the syncing is disabled.
  1044.  
  1045. L.Ctrl  on/off  gadgets  allow  you  to  easily  send  Local  control on/off
  1046. messages.
  1047.  
  1048. Suppr.N.Off  suppresses  Note  Off messages of the current instrument.  Some
  1049. devices  may  have  some  instruments  (e.g.   one-shot  drum  sounds) which
  1050. actually  ignore  the Note Off messages.  When Suppr.N.Off is selected, Note
  1051. Offs are not sent for the current instrument.  This reduces some unnecessary
  1052. MIDI output (slightly faster).
  1053.  
  1054. There  are  commands  which  control  the pitchbender, modulation wheel etc.
  1055. Detailed documetation later (again??).
  1056.  
  1057. ------- Entering notes with MIDI
  1058. You  can  use  your  keyboard, synthesizer or whatever, to insert notes (you
  1059. don't need to use your Amiga's keyboard to entering).  You must activate the
  1060. "Input"-gadget.   If  editing  is  on and your MIDI-device is sending notes,
  1061. they  will be entered.  You can also enter Amiga-samples with MIDI.  Next to
  1062. the  Input-gadget, there's a integer gadget, that contains the number of the
  1063. input  MIDI  channel.   If  it's 0, then MED will accept input from all MIDI
  1064. channels.
  1065.  
  1066. "Read volume" gadget may be sometimes quite useful.  If you have a velocity-
  1067. sensitive  keyboard, the volume will be entered in the command-part when you
  1068. enter  notes  and  this gadget is selected.  "Read key-up" is not as useful.
  1069. When  it's  active,  MED records key-up events.  It can be used in real-time
  1070. recording (and mostly for long notes).
  1071.  
  1072. You  may  have noticed that you can't directly use all the octaves which are
  1073. available  on  the MIDI device.  "Instrument transpose" helps this.  You can
  1074. have two instruments with identical settings except for different instrument
  1075. transpose.  With instrument transpose you can reach nearly the full range of
  1076. notes.
  1077.  
  1078. NOTE: When you have a MIDI-instrument, its name doesn't really have any use.
  1079.       However it's good practice to type in the names of the presets. This
  1080.       way you can easily see the presets, and, if you give the song to
  1081.       somebody else who may have different MIDI-equipment, he/she can
  1082.       easily change the preset numbers to use the correct presets on his/her
  1083.       MIDI-device.
  1084.  
  1085. +=========================================================+
  1086. |        Trans
  1087. +=========================================================+
  1088.  
  1089. Starting  from  the  bottom,  there's  a long string gadget that can hold an
  1090. annotation  text  for  the  song.   When you save the song, the text in this
  1091. gadget will be saved, and it will be displayed when loading the song.
  1092.  
  1093. The  other  functions  of  this  panel  has something to do with transposing
  1094. notes.
  1095.  
  1096. When  you're doing some transposing, you should first decide which areas the
  1097. transposing  should  affect.   At  the top of the panel there are gadgets to
  1098. select this:
  1099.     Affect/song     the functions of this panel will affect the whole song
  1100.     Affect/block    the functions will affect the current block
  1101.     Affect/track    current track will be affected
  1102.     Affect/sel.trks selected tracks in this block will be affected
  1103.     Affect/range    the range selected with mouse will be affected
  1104.  
  1105.     Instr/all       all instruments affected
  1106.     Instr/curr      only the current instrument affected
  1107.  
  1108. First there are some simple transposing operations:
  1109.     1/2 ^ (<-arrow up) transposes the affection area up one half-step
  1110.     1/2 v (<-arrow down) transposes down one half-step
  1111.     oct ^ transposes one octave up
  1112.     oct v transposes one octave down
  1113.  
  1114. ------- Note (ex)change
  1115. Suppose  you want to change all D-3's of instr 2 in your song to C-1.  First
  1116. you  set  Affect/song  (affect the whole song).  The you go to instrument #2
  1117. and select Instr/curr (to affect only this instrument).
  1118.  
  1119. Now  you  click the box at the right of the text "Note", hold down the mouse
  1120. button,  and  enter note D-3 from keyboard (D-3 will be displayed).  This is
  1121. the  source  note  name.   Then you click the box at the right of the source
  1122. note  box, hold the mouse button again, and enter C-1.  Now you have set the
  1123. destination note.
  1124.  
  1125. Finally  you just click the "->" gadget at the right of the dest.  note box.
  1126. If  you  had  wanted  to exchange the notes (D-3 => C-1 AND C-1 => D-3), you
  1127. would have clicked the "<->" gadget instead.
  1128.  
  1129. ------- Instrument deletion/changing
  1130. The left instrument number is the source number and the right one is
  1131. the destination number. To set them, select the instrument (e.g. Shift-
  1132. cursor left/right) and click on the number.
  1133. Del        Deletes the notes with source instrument number.
  1134. ->         Changes the source instrument number to dest. instrument number
  1135. <->        Exchanges the source and instrument numbers
  1136.  
  1137. ------- Play transpose
  1138. This gadgets allows you transpose the whole song quickly.  It doesn't change
  1139. the notes, it only affects playing.
  1140.  
  1141. +=========================================================+
  1142. |       Range
  1143. +=========================================================+
  1144.  
  1145. This  panel  contains  many  of  the  range-editing options.  The range is a
  1146. rectangular  area of notes in a block.  It is selected by dragging using the
  1147. right  mouse  button and (then moving the mouse).  It only works on vertical
  1148. note display.
  1149.  
  1150. The  numbers  at the right bottom corner show you the starting/ending tracks
  1151. and starting/ending lines of the block.
  1152.  
  1153. At  the left side of the panel, there are gadgets "Select track" and "Select
  1154. block".   These allow you to select a single track or block quickly.  To the
  1155. right  of  them,  there  are  gadgets for range operations.  The simplest is
  1156. "Clear".   It  clears  all  notes in the range.  Above it is "Cut".  It also
  1157. clears  the  notes,  but  copies  them to the copy buffer for later pasting.
  1158. "Copy"  doesn't  clear  the notes, just copies them to the copy buffer.  You
  1159. can  paste  the  contents  of the copy buffer with "Paste".  The copy buffer
  1160. will  then  be  copied  starting at the cursor.  If the copy buffer contains
  1161. e.g.   3  tracks, and you don't want to copy them to consecutive tracks, but
  1162. e.g.   tracks  2,  7,  and  9,  You  would  select  tracks  2, 7, and 9 with
  1163. track-selection  gadgets  (at  the top), and then click "Paste select".  The
  1164. notes  will  be  pasted only to selected tracks.  The "Cancel" gadget can be
  1165. used to forget the range (e.g.  if you've accidentaly hit the RMB).  You can
  1166. achieve the same effect with moving to another block.
  1167.  
  1168. Spread  2/3/4  allow you to spread notes on one track to consecutive tracks.
  1169. For  example,  get  an  empty block, fill track 0 with notes, select track 0
  1170. (with "Select track" for example), and try these gadgets.
  1171.  
  1172. S1, S2          These gadgets can perform the quite tedious task of
  1173.                 creating slides. Here's how it works (example):
  1174.  
  1175.                 You want to make a slide from C-2 to G-2:
  1176.  
  1177.                     000 C-2 1000
  1178.                     001 --- 0000
  1179.                     002 --- 0000
  1180.                     003 --- 0000
  1181.                     004 --- 0000
  1182.                     005 G-2 1000
  1183.                     006 --- 0000
  1184.  
  1185.                 Move the cursor to the line where you want the
  1186.                 slide to begin (in this example, line 002). Then click
  1187.                 S1 or S2. Result:
  1188.  
  1189.                 If you click S1         If you click S2
  1190.                    000 C-2 1000            000 C-2 1000
  1191.                    001 --- 0000            001 --- 0000
  1192.                    002 G-2 1306            002 --- 0108
  1193.                    003 --- 0306            003 --- 0108
  1194.                    004 --- 0306            004 --- 0108
  1195.                    005 --- 0306            005 G-2 1000
  1196.                    006 --- 0000            006 --- 0000
  1197.  
  1198.                 The better result is usually achieved using S1. S1 and S2
  1199.                 use the different sliding commands (that's the difference).
  1200.                 With S2, the second note is also replayed. The commands
  1201.                 itself are documented later.
  1202.                         Keyboard: S1 = Amiga-T, S2 = Shift-Amiga-T
  1203.  
  1204. VOL             Creates a volume slide. With this option, it's possible
  1205.                 to create easily fades etc. Example:
  1206.  
  1207.                 009 --- 0C50 <-start volume   \    009 --- 0C50
  1208.                 010 --- 0000  =================\   010 --- 0C47
  1209.                 011 --- 0000  | Click "VOL"     \  011 --- 0C44
  1210.                 012 --- 0000  |                 /  012 --- 0C40
  1211.                 013 --- 0000  =================/   013 --- 0C37
  1212.                 014 --- 0C34 <-end volume     /    014 --- 0C34
  1213.  
  1214.                 The cursor must be positioned somewhere between the C-
  1215.         commands (on lines 10 - 13 in this example).
  1216.  
  1217. Select: 0, 1, 2, ... E, F
  1218.         These gadgets are used to select tracks (not range). Some track-
  1219.         based operations may need this (e.g. Paste select), or you can set
  1220.         the transpose operations to affect the selected tracks.
  1221.         ST selects all tracks, while CL deselects them.
  1222.  
  1223. Chord
  1224.         This gadget can be used if you want to enter chords. First you
  1225.         should select the tracks, which the chord entering affects (with
  1226.         above gadgets). The chord always starts from the current track and
  1227.         then continues to the next selected track etc...
  1228.         After you've selected this gadget and turned editing on, you can
  1229.         try entering a major C-chord (select all tracks now, because this is
  1230.         just an example!!).
  1231.         Press Q (C), hold it down. Then press E (E) holding both keys still
  1232.         down. Finally T (G). Now you can release the keys, and the cursor
  1233.         moves back to the starting track and advances line.
  1234.         Chord editing works well with MIDI too.
  1235.  
  1236. ============================================================================
  1237. ============================================================================
  1238.         Big displays
  1239.  
  1240. MED  has  some panels, that are displayed in the large area (where the notes
  1241. usually  are).   The  rightmost strip of panel-selection gadgets are used to
  1242. select one of the five possible big displays.  The displays (gagdets) are:
  1243.  
  1244.         Vertical note display
  1245.         (Notation editor, in OctaMED V2 only!)
  1246.         Synthetic sound editor
  1247.         Sample editor
  1248.         Sample list
  1249.  
  1250. *===========================================================================
  1251. *       Synthetic sound editor
  1252. *===========================================================================
  1253. See the doc file "Synthsounds.doc"...
  1254.  
  1255. *===========================================================================
  1256. *       Sample editor
  1257. *===========================================================================
  1258. See the doc file "Sample_editor.doc"...
  1259.  
  1260. *===========================================================================
  1261. *       Sample list
  1262. *===========================================================================
  1263.  
  1264. ------- What is it??
  1265. Sample list is a list of all your samples and sample disks/directories.  You
  1266. can  easily scan through your sample lists and load a sample by clicking its
  1267. name.   When  you've  constructed  the  sample  list, it is saved and always
  1268. loaded  when you run MED.  You don't have to load directories of your sample
  1269. disks  more  than  once.   Sample  list  (MED_paths)  contains the directory
  1270. declarations, so MED can automatically load your samples from correct disks,
  1271. minimizing disk swappings, when you load songs.
  1272.  
  1273. ------- How to create a Sample list??
  1274.  
  1275.           Using the filerequester, load the directory of your sample
  1276.           disk/dir. Then go to the "SList"-panel. Now click Dir/ADD.
  1277.           You should see the filenames of the directory to appear.
  1278.           You can now examine the list, and if there are files which
  1279.           are not samples, destroy them from the list with Instr/DEL.
  1280.           Repeat this procedure for each sampledisk/dir you have.
  1281.           You can select the displayed directory with the right display,
  1282.           which displays the directory names.
  1283.  
  1284.           When you have made the list, you probably want to save it.
  1285.           Save/S: does the job. If you click CD, the path file will be
  1286.           saved to the current directory (be sure that it is the same where
  1287.           you started MED). If you click "S:", the file will be saved
  1288.           to the S:-directory. I prefer placing the file in S:, because
  1289.           then it doesn't matter which is the current directory when
  1290.           starting MED. The file is called "MED_paths".
  1291.  
  1292.           If you later want to add entries to the directory, you can
  1293.           delete the whole directory from the list with Dir/DEL. Then you
  1294.           must click the name of the directory to remove.
  1295.           Then you can reload the directory. You can also add entries
  1296.           one at a time. If you click Instr/ADD, the name of the
  1297.           current sample is added to the list. Also the repeat/rep.length
  1298.           values are then added to the list (form: Asia::480/5362).
  1299.           Note that the previous entry with same name is not deleted,
  1300.           so you must delete it by hand (using Instr/DEL), if you want to
  1301.           add rep./rep.len values to the list.
  1302.  
  1303.           If the current instrument is a MIDI-instrument when you add
  1304.           the name, the name will be a form E.Piano::M6/4 . The 1st
  1305.           number is the channel, the 2nd is the preset. When you later
  1306.           load instrument of that name, the MIDI-channel/preset will be
  1307.           set. Note that the instrument with this name doesn't really
  1308.           have to exist in that directory, it's like a "dummy" entry.
  1309.           You may want to create a "dummy" directory for these dummy
  1310.           MIDI entries (empty dir).
  1311.  
  1312.           At the top is the box displaying the directory name and number.
  1313.           The right display only displays the last 16 chars of the dir
  1314.           name, because it's the most meaningful. For example
  1315.           some of my instruments are located in directory:
  1316.  
  1317.                 work:samples/ST-01/
  1318.  
  1319.           If the box showed the first 16 chars, it would be
  1320.           "work:samples/ST-" (which isn't as helpful).
  1321.  
  1322.           The instrument loading is simple. Just click the instrument name
  1323.           on the left display, and it's loaded.
  1324.  
  1325. ------- Loading MED_paths
  1326.  
  1327.           You can load a new MED_paths file, using the file requester.
  1328.           If you select a file called MED_paths, you'll be immediately
  1329.           requested if you want to load it. If you press 'R', the list
  1330.           in the memory will be lost and the new one will be loaded. If
  1331.           'A' is pressed, the current path list is preserved and the new
  1332.           one will be appended to it.
  1333.  
  1334.           Finally, I reveal the keyboard shortcuts...
  1335.  
  1336.                 Alt-numeric keypad-8 = scroll the list up (very useful)
  1337.                 Alt-numeric keypad-2 = scroll the list down (very too)
  1338.                 Alt-keypad-9 (PgUp)  = scroll the list up fast
  1339.                 Alt-keypad-3 (PgDn)  = scroll the list down fast
  1340.                 Alt-keypad-7 (Home)  = to the beginning of the list
  1341.                 Alt-keypad-1 (End)   = to the end of the list
  1342.  
  1343. +-------------------------------------------------------------------+
  1344. |+-----------------------------------------------------------------+|
  1345. ||             MED V3.2 player commands/effects                    ||
  1346. |+-----------------------------------------------------------------+|
  1347. +-------------------------------------------------------------------+
  1348.  
  1349. This  section  gives  information  about  commands/effects.  They are events
  1350. which affect the playing and they are handled by the MED player routine.
  1351.  
  1352.          C - 2  1 2 3 4
  1353.                   | \ |
  1354.      command number  \|
  1355.                       data byte
  1356.  
  1357. You insert the commands usually by hand (turn editing on, move cursor on the
  1358. command  numbers  and type the numbers).  It may be a bit easier if you turn
  1359. off automatic-advance with Ctrl-A.
  1360.  
  1361. Here are the descriptions of each of the currently recognized commands:
  1362.  
  1363.  
  1364. +---------------------------------------------------+
  1365. | Command 0:  ARPEGGIO       MIDI: controller value |
  1366. +---------------------------------------------------+
  1367.  
  1368. This command changes the pitch of the note quickly (6 times during 1 note).
  1369. It can be used to create "chords" or special effects. If you've listened
  1370. to music made with the C-64, you MUST have heard arpeggios. The pitch is
  1371. changed between 3 different pitches during one note:
  1372.          the 1st pitch is the pitch of the original note
  1373.          the 2nd pitch is the pitch of the original note + the 1st number
  1374.                 of databyte halfsteps up
  1375.          the 3rd pitch is the pitch of the original note + the 2nd number
  1376.                 of databyte halfsteps up
  1377.  
  1378. Note: 3rd pitch | 2nd pitch | 1st pitch | 3rd pitch | 2nd pitch | 1st pitch
  1379.       changed 6 times during note
  1380.  
  1381. It may be a bit difficult to understand, so here's an example:
  1382. You want to make an arpeggio which sounds like C-major chord.
  1383.  
  1384. The lowest pitch is C (C-2 in this example).
  1385. The second is E-2 (4 halfsteps higher than C-2).
  1386. The third is G-2 (7 halfsteps higher than C-2).
  1387.  
  1388. 4 halfsteps from C-2 -+ 7 halfsteps from C-2
  1389.                       |/
  1390. That produces:  C-2 1047
  1391.                 --- 0047
  1392.                 --- 0047 and so on...
  1393.  
  1394. Data byte for a minor chord would be 37.
  1395.  
  1396. The arpeggios sound better with some instruments than others.
  1397.  
  1398. MIDI: See command 5 for a description.
  1399.  
  1400. +---------------------------------------------------+
  1401. | Command 1:  SLIDE UP       MIDI: pitchbender up   |
  1402. +---------------------------------------------------+
  1403.  
  1404. This command slides up the pitch of the current track.
  1405.  
  1406. With Amiga samples:
  1407.          Decreases the period of the note the amount of databyte on each
  1408.          timing pulse. Sounds rather technical?? Yes... The instructions for
  1409.          previous (before 2.10) versions of MED contained detailed
  1410.          instructions for making good-sounding slides with this command.
  1411.          Because this version now contains the easy automatic slide making
  1412.          (Amiga-T), I felt that these instructions are not necessary any more.
  1413.          If you use this function for special effects (not real slides) then
  1414.          you can experiment with the values for the databyte.
  1415.          Example:
  1416.                 A-1 1000
  1417.                 --- 0000
  1418.                 --- 010F <- slide up a bit
  1419.  
  1420. With MIDI:
  1421.          This commands works very differently with MIDI. It actually
  1422.          "turns" the pitchbender 8 * databyte steps up on each timing pulse.
  1423.          Because the actual range of the pitchbender may be different with
  1424.          different MIDI-devices, you must find the right value by
  1425.          experimenting. There's also one thing you should know: when a new
  1426.          note is played, the pitchbender is not resetted automatically. To
  1427.          reset the pitchbender, you use this command with databyte zero.
  1428.          Example:
  1429.                 G-2 L1FF <-turn it up very quick
  1430.                 --- 0000
  1431.                 --- 0100 <- then reset the pitchbender
  1432.  
  1433.  
  1434. +---------------------------------------------------+
  1435. | Command 2:  SLIDE DOWN     MIDI: pitchbender down |
  1436. +---------------------------------------------------+
  1437.  
  1438. Not much about this command. It's just like command 1 except it slides
  1439. down.
  1440.  
  1441.  
  1442. +---------------------------------------------------+
  1443. | Command 3:  PORTAMENTO     MIDI: set pitchbender  |
  1444. +---------------------------------------------------+
  1445.  
  1446. This is another slide command (on some old MED versions (2.00) this
  1447. was a vibrato command, see command 5 now). It can be used to
  1448. make perfect slides more easily. First an example:
  1449.  
  1450.          C-2 5000 <- played note C
  1451.          --- 0000
  1452.          E-2 5305 <- this note is not played!! Instead, slide target is set
  1453.          --- 0300    to G-2 and slide speed is 5
  1454.          --- 0300 <- when speed is zero, use the previous speed
  1455.          --- 0306 <- the speed can be changed, of course
  1456.  
  1457. This example would slide from C-2 to E-2, but the slide stops EXACTLY
  1458. when E-2 is reached. The remaining 3's have no effect. This command
  1459. is easier to handle with automatic slide making (see Edit/S1 above).
  1460.  
  1461. MIDI: By using this command, you can set the pitchbender to an absolute
  1462. value, instead of sliding as commands 1 and 2 do. The data byte is the
  1463. pitchbender value, expressed as a signed hexadecimal digit (a nightmare
  1464. to non-programmers!).
  1465.         00 = center position
  1466.         80 (-7F) = smallest value
  1467.         7F = largest value
  1468.  
  1469. Example:
  1470.         C-2 3000
  1471.         --- 037F <- pitchbender to max. value
  1472.         --- 0300 <- reset
  1473.  
  1474.  
  1475. +---------------------------------------------------+
  1476. | Command 4:  VIBRATO        MIDI: modulation wheel |
  1477. +---------------------------------------------------+
  1478.  
  1479. The first number of the data byte is vibrato speed, the second is
  1480. vibrato depth. If the numbers are zeros, the previous speed and depth
  1481. is used.
  1482.  
  1483. Example: F-215000
  1484.          --- 0000
  1485.          --- 0433 <- slow, not much depth
  1486.          --- 0437 <- more depth
  1487.          --- 043F <- full depth
  1488.          --- 0482 <- fast, not very deep
  1489.  
  1490. MIDI: This command affects the modulation wheel of the current channel.
  1491.       The data byte can be 00 - 7F. 00 = no modulation, 7F = maximum.
  1492.       Values 80 - FF are reserved for future expansion (and won't work).
  1493.  
  1494.  
  1495. +---------------------------------------------------+
  1496. | Command 5:  OLD VIBRATO    MIDI: controller number|
  1497. +---------------------------------------------------+
  1498.  
  1499. This is the old vibrato command (previously it was 3). The command 3 is
  1500. automatically converted to 5 when loading old MED songs. The pitch of
  1501. the note is changed between two values, databyte is the depth.
  1502.  
  1503. Example: A#1 J502
  1504.          --- 0507 increasing depth
  1505.          --- 0517 v
  1506.          --- 0527
  1507.          --- 0537
  1508.  
  1509. MIDI: Command 5 in conjunction with command 0 allows you to change any
  1510. controller of MIDI (command $Bx cc vv, where cc = controller number,
  1511. vv = value).
  1512.  
  1513. First you set the number of controller you want to change with command
  1514. 5. Then you can select the value with command 0. Subsequent uses of
  1515. command 0 will affect the controller previously set with command 5.
  1516. Each channel has its own controller number. If the controller value is
  1517. $00, you can't use '00', because the command '000' means 'do nothing'.
  1518. Instead, you type '80'. Acceptable controller numbers and values are
  1519. $00 - $7F.
  1520.  
  1521. For example: (assuming instrument 3 is set to MIDI channel 1)
  1522.         C-2 3000
  1523.         --- 0507 <- controller $07, volume, according to MIDI standard
  1524.         D-2 307F <- set max. volume ($7F), command $B0 $07 $7F is sent
  1525.         --- 0000
  1526.         F-3 3001 <- small volume ($01)
  1527.         --- 055C <- select controller $5C (tremolo depth)
  1528.         G-4 3080 <- set to 0 (note: $80 = $00)
  1529.  
  1530. +---------------------------------------------------+
  1531. | Command 8:  SET HOLD/DECAY MIDI: set hold only    |
  1532. +---------------------------------------------------+
  1533.  
  1534. This command must be located on the same line with a note. The command
  1535. assigns the hold and decay values for the note (see above for description
  1536. about hold/decay).
  1537.  
  1538.                 hold value
  1539. decay----------+|
  1540.                ||
  1541. Example: C-3 3824
  1542.          -|- 3000
  1543.          -|- 3000
  1544.          --- 0000
  1545.  
  1546. +---------------------------------------------------+
  1547. | Command 9:  SEC. TEMPO     MIDI: no action        |
  1548. +---------------------------------------------------+
  1549.  
  1550. This command sets the secondary tempo (the number of timing pulses/note).
  1551. The argument must be 01 - 20.
  1552.  
  1553. Example: --- 0903 <= double tempo
  1554.          --- 0000
  1555.  
  1556. +---------------------------------------------------+
  1557. | Command A:  VOLUME SLIDE   MIDI: polyph aftertouch|
  1558. +---------------------------------------------------+
  1559.  
  1560. This is the same as command D (for Noise/Protracker compatibility).
  1561. However, please use D instead of this. If I some day find that there
  1562. are no free commands, I'll use this!!
  1563.  
  1564. MIDI: Command A changes the polyphonic aftertouch of the most recent note.
  1565. The value should be $00 - $7F.
  1566. Example:
  1567.         C-3 4000
  1568.         --- 0A30 <- aftertouch $30
  1569.         --- 0000
  1570.         --- 0A00 <- aftertouch $00
  1571.  
  1572. +---------------------------------------------------+
  1573. | Command B:  POSITION JUMP  MIDI: position jump    |
  1574. +---------------------------------------------------+
  1575.  
  1576. This command lets you make songs that have beginning which is played
  1577. only once and then some part which is looped forever. Position jump
  1578. causes the jump to playsequence number pointed by the data byte. If the
  1579. data byte is 0, then the playseq jumps to the first entry.
  1580.  
  1581. Example:    --- 0B02 <- start playing from playsequence number 3
  1582.  
  1583. +---------------------------------------------------+
  1584. | Command C:  SET VOLUME     MIDI: set volume       |
  1585. +---------------------------------------------------+
  1586.  
  1587. You can override the default volume of the instrument with this command.
  1588. Example:
  1589.          A-3 4C20 <- played with volume 20
  1590.  
  1591. There are 65 volume levels (0 - 64), 0 = no sound, 64 = maximum. The
  1592. data byte of command C can be 00 - 64 or 00 - 40 (decimal or hex).
  1593. Non-programmers will probably want to use the decimal numbers. See
  1594. (Play/[Dec/Hex]). If you want the playroutine to have maximum performance,
  1595. then use hex values.
  1596.  
  1597. It is also possible to change the volume of already played note. Note
  1598. that it doesn't work with MIDI-instruments.
  1599.  
  1600. Example:
  1601.          A-3 4000
  1602.          --- 0000
  1603.          --- 0C10 <- volume to 10
  1604.  
  1605. It's possible to change the default volume of an instrument (MED V2 and
  1606. later). The value must be between 80 and C0 (always hex!). Value $80 = volume
  1607. 0, and $C0 = 64. Note: This can cause trouble in multi-modules, because the
  1608. set of instruments (and their default volumes) are common. I recommend that
  1609. you change the default volume only on non-multi-modules.
  1610.  
  1611. +---------------------------------------------------+
  1612. | Command D:  VOLUME SLIDE   MIDI: channel pressure |
  1613. +---------------------------------------------------+
  1614.  
  1615. You can increase/decrease volume smoothly with this command. The data
  1616. byte is divided in two parts:
  1617.  
  1618.          C-3 3D01
  1619.                ||
  1620.                |+- Amount of decresdendo
  1621.                +-- Amount of crescendo
  1622.  
  1623. If crescendo is zero, then the decrescendo is performed. Otherwise only
  1624. crescendo is performed.
  1625.  
  1626. Example:
  1627.          C-2 3C40
  1628.          --- 0D01 <- a bit more quiet
  1629.          --- 0D01 <- even more
  1630.          --- 0D20 <- and crescendo back to original
  1631.  
  1632. One unit in these commands means six actual volume units, so this example
  1633. would look like this, when using the C-command (except that it doesn't
  1634. sound so smooth):
  1635.          C-2 3C40 (volumes are decimal in this example)
  1636.          --- 0C34 <- -6
  1637.          --- 0C28 <- -6
  1638.          --- 0C40 <- +12
  1639.  
  1640. MIDI: This command sends a channel pressure (channel aftertouch) message
  1641. using the channel in which the most recent note was sent. The databyte
  1642. should be $00 - $7F.
  1643.          D#5 J000
  1644.          --- 0D40 <- channel aftertouch $40
  1645.          --- 0D00 <- to $00
  1646.  
  1647. +---------------------------------------------------+
  1648. | Command E:  SYNTH/JMP      MIDI: pan control      |
  1649. +---------------------------------------------------+
  1650.  
  1651. When used with synth/hybrid instruments, this command triggers a jump
  1652. in the waveform command sequence. The databyte is the jump destination
  1653. (line number).
  1654.  
  1655. Example: C-4 4000 <- this should be synth/hybrid instrument
  1656.          --- 0000
  1657.          --- 0E05 <- cause a jump to line # 5
  1658.  
  1659. With MIDI-instruments, this command controls the stereo location of the
  1660. sound. The data byte can be 00 - 7F.
  1661.  
  1662.         left           mid            right
  1663.          |              |               |
  1664.         00             3F               7F
  1665.  
  1666. If you've used MED V2.00/V2.01 or Noise/SoundTracker, you may remember
  1667. that this command controlled the low-pass filter. I think that it was
  1668. unnecessary to spend the command E only for controlling only a single
  1669. switch. See command F.
  1670.  
  1671. +---------------------------------------------------+
  1672. | Command F:  TEMPO/MISC.    MIDI: tempo/misc.      |
  1673. +---------------------------------------------------+
  1674.  
  1675. Command F has many different actions depending on the data byte.
  1676.  
  1677. If the data byte is zero (00), this command causes the immediate jumping
  1678. to the next block on the playing sequence (or to the beginning of this
  1679. block if you're only playing the block). This function is better to
  1680. implement by making the block shorter (takes less memory).
  1681.  
  1682. Example:
  1683.          C-2 4F00 <- this is the last note of this block
  1684.  
  1685. When the data byte if 01 - F0, the command changes the tempo. This is the
  1686. primary tempo (length of the pause between timing pulses).
  1687.  
  1688. If the new tempo is 01 - 0A, it is compatible with Trackers, but now you
  1689. should use the command 9 instead of this command, as it's directly
  1690. Tracker-compatible (set the primary tempo to 33).
  1691.  
  1692. Example:
  1693.          E-3 6FF0 <- highest tempo
  1694.          --- 0000
  1695.          --- 0F0B <- slowest
  1696.  
  1697. Data bytes FF1 - FFF are reserved for special actions, some of them
  1698. are currently used:
  1699.  
  1700. FF1 causes the same note played actually twice. This way it's possible
  1701. to create fast rhythms.
  1702.  
  1703.          C-3 2FF1 is same as C-3 2000
  1704.                              C-3 2000 with double tempo
  1705.  
  1706. FF2 plays the note only once, but it is not started immediately:
  1707.  
  1708.          C-3 2FF2 is same as --- 0000
  1709.                              C-3 2000 with double tempo
  1710.  
  1711. FF3 works like FF1 except the note is played three times (very fast).
  1712.  
  1713. FF8 turns off the low-pass filter (power-LED will dim).
  1714.  
  1715. FF9 turns the low-pass filter on (bright LED).
  1716.  
  1717. FFA sends MIDI "hold pedal on"-command (works only with MIDI-instruments).
  1718.  
  1719. FFB sends MIDI "hold pedal off"-command (works only with MIDI-instruments).
  1720.  
  1721. FFD works only with Amiga-samples. It causes the pitch of the channel to
  1722.     be set to the pitch of the new note, but the new note is not replayed.
  1723.  
  1724.          C-1 2000 <- play note
  1725.          --- 0000
  1726.          C-2 2FFD <- don't replay the note, just set the pitch to C-2
  1727.  
  1728. FFE stops playing immediately. If you want to make a song which plays only
  1729.     once, put this command to the end of the song. This command can be
  1730.     easily entered: Click "Stop playing" while holding the Shift-key.
  1731.  
  1732. FFF Stops the note on the current track. Works with both Amiga- and MIDI-
  1733.     instruments. Nearly identical to "C00" on Amiga-samples, but because
  1734.     "C00" doesn't work with MIDI, I made this command.
  1735.  
  1736.  
  1737. +-------------------------------------------------------------------+
  1738. |+-----------------------------------------------------------------+|
  1739. ||             MED V3.20 keyboard equivalents/functions            ||
  1740. |+-----------------------------------------------------------------+|
  1741. +-------------------------------------------------------------------+
  1742.  
  1743.       Cursor up              Cursor up
  1744.       Cursor down            Cursor down
  1745.       Cursor right           Cursor right
  1746.       Cursor left            Cursor left
  1747. -- then a bit more complex ones
  1748.       DEL                    Delete note or number under cursor
  1749.       Shift-DEL              Delete the note and the command numbers
  1750.       Alt-DEL                Delete only the command numbers
  1751.       Backspace              Deletes the note and moves following notes up
  1752.       Shift-Backspace        Inserts an empty note slot
  1753.       Alt-Backspace          Deletes the current track
  1754.       Alt-Shift-Backspace    Inserts a new track
  1755.       Shift-Cursor up        Previous block
  1756.       Shift-Cursor down      Next block
  1757.       Shift-Cursor left      Previous sample
  1758.       Shift-Cursor right     Next sample
  1759.       Left-Alt-Cursor up     First block
  1760.       Left-Alt-Cursor down   Last block
  1761.       Alt-Cursor left        Cursor onto previous track
  1762.       Alt-Cursor right       Cursor onto next track
  1763.       Alt-Shift-Cursor right 16 samples forward
  1764.       Alt-Shift-Cursor left  16 samples backward
  1765.       Ctrl-Cursor left       Previous screenful of tracks
  1766.       Ctrl-Cursor right      Next screenful of tracks
  1767.       Space bar              Stop playing (or delete note if SPC=CLR active)
  1768.       Alt-Space              Continue block
  1769.       Ctrl-Space             Reset MIDI pitchbenders/mod. wheels/presets
  1770.       Shift-Space            Continue song
  1771.       Shift-Alt-Space        Play song
  1772.       Esc                    Editing on/off
  1773.       ~                      Extra space on/off
  1774.       F1 - F4                Select keyboard octaves 1+2 - 4+5.
  1775.       F6                     Cursor to the first line of the block
  1776.       F7                     Cursor to the second quarter of the block
  1777.       F8                     Cursor to the middle of the block
  1778.       F9                     Cursor to the last quarter of the block
  1779.       F10                    Cursor to the last line of the block
  1780.       Ctrl-F1 - F10          Select displayed panel
  1781.       Ctrl-Shift-0 - 9       Pick note 0 - 9
  1782.       Ctrl-A                 Automatic advance down on/off
  1783.       Ctrl-F                 Display free memory
  1784.       Amiga-F                Low-pass filter on/off
  1785.       Amiga-I                Activate sample name gadget.
  1786.       Shift-Amiga-I          Clear and activate sample name gadget
  1787.       Amiga-J                Jumping on/off for this sample
  1788.       Amiga-L                Load song
  1789.       Amiga-P                Play song (Shift-Alt-Space)
  1790.       Amiga-R                Activate repeat gadget (in Sample-panel)
  1791.       Amiga-T                Create slide using command 3 (transform)
  1792.       Amiga-Shift-T          Create slide using command 1 and 2
  1793.       Amiga-X/C/V            Cut/copy/paste current track
  1794.       Amiga-Shift-X/C/V      Cut/copy/paste current block
  1795.       Shift-0 - 9            Enter note 0 - 9
  1796.       TAB                    Highlight current line
  1797.  
  1798. Numeric keypad (the non-shifted operations are described in Edit/pad on/off)
  1799.       Ctrl-8             Scroll the playing sequence list up
  1800.       Ctrl-2             Scroll the playing sequence list down
  1801.       Ctrl-4             Decrease the block number of the psl
  1802.       Ctrl-6             Increase the block number of the psl
  1803.       Ctrl-7             Move to the beginning of the psl (psl = the
  1804.       Ctrl-1             Move to the end of the psl        playing
  1805.       Ctrl-5             Insert this block to the psl      sequence
  1806.       Ctrl-0             Insert number 0 to the psl        list)
  1807.       Ctrl-.             Delete the block number from the psl
  1808.       Alt-8              Scroll samplelist up
  1809.       Alt-2              Scroll samplelist down
  1810.       Alt-9              Scroll samplelist up fast
  1811.       Alt-3              Scroll samplelist down fast
  1812.       Alt-7              Beginning of the samplelist
  1813.       Alt-1              End of the samplelist
  1814.